home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / bblist11.zip / BBLIST.DOC < prev    next >
Text File  |  1990-07-15  |  10KB  |  201 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.         Bulletin Board List v1.1 (c)
  7.         by Wayne Robinson
  8.         The Quantum Zone
  9.         (201) 307-1452
  10.         FIDO 1:269/309
  11.  
  12.         Just what the world needed, another BBS List, huh? Well this 
  13.         little program will make keeping a local list pretty easy. It 
  14.         supports quite a few different BBS systems, thanks to Scott Baker 
  15.         and Derrick Parkhurst and their excellent DoorDriver. This door 
  16.         was written in Turbo Pascal 5.5 with DoorDriver 3.0. It supports 
  17.         ANSI color and monochrome as well as non-ANSI. It will run with a 
  18.         locked port up to 38400 and will utilize a fossil if one is 
  19.         found. If not, well it has its own routines to handle the comm, 
  20.         though if you are running an HST or other 9600 baud modem, you 
  21.         really should use a fossil.
  22.  
  23.         This package contains:
  24.  
  25.         BBLIST.EXE   <--- The main executable door program
  26.         BBLIST.DOC   <--- This documentation
  27.         BBLIST.CTL   <--- A sample control file 
  28.         BBMERGE.EXE  <--- BBLIST.DAT merging utility
  29.  
  30.         The door will create:
  31.  
  32.         BBLIST.DAT   <--- A text file containing the data input by the 
  33.                           users or yourself. You may edit this with any 
  34.                           ASCII text producing word processor.
  35.  
  36.         Setup is easy. Just put BBLIST.EXE, BBMERGE.EXE, and BBLIST.CTL 
  37.         in a directory. Edit BBLIST.CTL to match your system. It contains 
  38.         instructions in itself. Make certain that your archival utility 
  39.         and DSZ are where you tell BBLIST they are supposed to be. You 
  40.         may use any archival utility you like, but you are stuck with DSZ 
  41.         as protocol driver. The BBList door will utilize it to send with 
  42.         X-Modem, Y-Modem, and Z-Modem. That should meet everyone's needs, 
  43.         really, and no other protocol driver supports the number of 
  44.         options as DSZ. 
  45.  
  46.         Running the door will involve providing BBList with the 
  47.         appropriate exit file. It currently supports, QBBS, RBBS-PC, 
  48.         Wildcat, Phoenix, PCBoard 12, WWIV, Mach-10, Opus, and RBBS 16.x 
  49.         types of exit files. You must copy this exit file (ie: 
  50.         pcboard.sys) to the BBLIST directory before BBLIST.EXE is run. 
  51.         Since Doordriver has recorded, in BBLIST.CTL, the type of system 
  52.         you are running or emulating it will know what file to expect. 
  53.         With QBBS and RBBS 16.x you must provide the node number to 
  54.         BBLIST.EXE so that it will know which exit file to look for. 
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.         Example: 'BBLIST 1' will look for dorinfo1.def. If you are 
  62.         running on Searchlight you can use the pcboard.sys version 14 
  63.         file, (ie: 10;0;0;10;BBList 1.1;c:\doors;bblist.bat). PCBoard 12 
  64.         does not supply the node number in pcboard.sys so you will have 
  65.         to use 'BBLIST 1' for node 1, etc. if you run that version.
  66.  
  67.         Operation of the Door is very simple. After the opening screen, 
  68.         your user is presented with a menu in the middle of the screen. 
  69.         
  70.                                 BBList Main Menu
  71.  
  72.                              <A> View the BBS list
  73.                              [B] Enter a new BBS
  74.                              [C] Search for key text
  75.                              [D] Download the list
  76.                              [Q] Quit to BBS
  77.                     
  78.                                 Enter your choice
  79.  
  80.         You can either use the cursor keys (with numlock on) or you can 
  81.         press a 'hot-key' letter to activate a function. [D]ownload will 
  82.         get another menu that offers the 3 types of protocols. The list 
  83.         is automatically packed with your preference of archivers. And 
  84.         the user informed of the filename.
  85.        
  86.         The BBS list file is a text file with a header created by the 
  87.         program which explains the notations in the file. You may edit 
  88.         it, but I warn you if you change the number of lines in the 
  89.         header it will seriously change the sorting and searching 
  90.         routines. When a BBS is entered via a series of menus, it is 
  91.         inserted into the list according to area code order. When you try 
  92.         to add a BBS with the same phone number it will ask you if you 
  93.         wish to replace the original entry. If you say no, then the 
  94.         present entry will be cancelled. There is at present no way to 
  95.         delete a BBS whose number has been changed. When you enter it 
  96.         anew the old one will still exist. I will put this feature into a 
  97.         sysop utility at a later date. You may of course edit the BBS 
  98.         entries with a word processor and delete an entry that way. Just 
  99.         don't change the length of the file header and for Pete's sake 
  100.         don't use some non ASCII editor. 
  101.  
  102.         The search routine is quite simple. It will find the first 
  103.         occurance of any string and begin the display of the list at that 
  104.         line. It was not intended to be a major data-base like search 
  105.         routine. It is just a quick way to look for a certain area code 
  106.         or sysop's name, or BBS name. Searching for CD will only get the 
  107.         first occurance so it is not a way to find all of the BBS's with 
  108.         CD-ROMS. The routine is not case sensitive.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.         The display routine is a straight file dump with a routine 'more, 
  116.         stop, non-stop' type of interface. If you choose non-stop it will 
  117.         not prompt you again until the end of the file. Hitting Enter 
  118.         will default to the 'more' prompt and send one more page. 
  119.  
  120.         The status line at the bottom of the screen contains the user's 
  121.         name, the program name and the amount of time left for this user 
  122.         online. If the user runs out of time while in the door he will be 
  123.         tossed out to the BBS. Carrier is constanty monitored and the 
  124.         door will terminate if the user drops carrier. 
  125.  
  126.         The utility BBMerge, is run with no parameters in the BBList 
  127.         directory. It will prompt you for the path and name of another 
  128.         list file, which you want to merge with your own. This file MUST 
  129.         be on made by BBList and in unaltered state. It can have any 
  130.         filename you like. BBMerge will merge the two files and sort them 
  131.         into phone number order. BBMerge will replace all duplicate 
  132.         entries in BBLIST.DAT with the entries found in the new merge 
  133.         file. This can be done automatically or you can choose to be 
  134.         prompted for a decision on each individual duplicate. In the 
  135.         prompted mode, you may elect not to replace the original in 
  136.         BBLIST.DAT with the merge file's duplicate entry.
  137.  
  138.         If you would like to be included in the national BBLIST.DAT file 
  139.         you can either file attach your BBLIST.DAT to my board or call 
  140.         and upload it. New callers may upload on the first call. If you 
  141.         do either please leave me a note telling me, so I can merge the 
  142.         file soonest. The program BBList can be obtained via freq with 
  143.         the magic name BBLIST at HST speeds 24 hours a day. It should 
  144.         also be obtainable via any DDS node.
  145.  
  146.         The author of this program makes no warrantee of useability, 
  147.         function, or application. No liability will be assumed for any 
  148.         damage caused by BBLIST either directly or indirectly because of 
  149.         its use. If you use BBLIST you agree to this. Some states do not 
  150.         permit this type of exclusion. If you live in one of these 
  151.         places, you are not permitted to use BBLIST. This program is the 
  152.         sole property of Wayne Robinson and may not be sold by anyone at 
  153.         any price. It was intended for distribution via electronic means 
  154.         on a BBS system and you may not distribute it in any other way if 
  155.         there is a cost to the end receiver involved, including cost of 
  156.         transfer media and shipping. This package may not be distributed 
  157.         in any altered form. It must contain this documentation, the 2 
  158.         programs, BBLIST.EXE and BBMERGE.EXE, and BBLIST.CTL the example 
  159.         control file in an unaltered state. You may, at your discretion, 
  160.         repack it with your choice of archival utility. It may be 
  161.         included with another program if no additional cost is made for 
  162.         BBLIST and if the packager of the other program gives me credit 
  163.         for my work and informs the end user that he is not charging for 
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.         BBLIST. Whew, I'm a picky guy huh? To the sysops out there. This 
  172.         is not a registerable program. It is, as it is, free. There is no 
  173.         secret version. If you like it, use it and the next time you go 
  174.         out for a beer, toss one for me (Beerware). That is all the 
  175.         thanks I want or need. 
  176.  
  177.         The future will bring some enhancements. If you have an idea let 
  178.         me know on my BBS or via net-mail. I always like to discuss ideas 
  179.         for my programs.
  180.  
  181.         I would like to thank the authors of the Darwin US BBS list for 
  182.         their file format, which I sort of borrowed and altered a little. 
  183.         It was their ideas which showed me the way I wanted to go. This 
  184.         is not a competition with them, since they do not publish a list 
  185.         utility to my knowlege. What they do is keep the best BBS list that 
  186.         I know of.
  187.  
  188.                                            Wayne Robinson
  189.  
  190.  
  191.  
  192.         History:
  193.  
  194.         1.1     Added BBMerge
  195.                 Converted to DoorDriver 3.0 and dropped BBCNFG.EXE
  196.                 Fixed bug that allowed partial phone number
  197.  
  198.         1.0     First public release
  199.  
  200.  
  201.